home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 1 / CU Amiga Magazine CD-ROM Special Edition (1995)(EMAP Images)(GB)[Issue 1995-11].iso / Aminet / comm / bbs / IceOLR32.lzh / IceOLR / IceOLR.Doc < prev    next >
Encoding:
Text File  |  1995-05-06  |  17.0 KB  |  360 lines
  1.                                IceOLR
  2.  
  3.  
  4.             The Off Line Reader for the IceBBS message bases
  5.  
  6.                    Copyright 1993 Stephen Vermeulen
  7.                        Calgary, Alberta, Canada
  8.  
  9.                        Voice:  (403) 282-7990
  10.  
  11.                          BBS:  (403) 284-5625
  12.                          BBS:  (403) 284-2048
  13.  
  14.  
  15.                 THIS IS A SUMMARY OF WHAT HAS CHANGED IN EACH
  16.                 RELEASE SEE THE IceOLR.GUIDE FILE FOR THE COMPLETE
  17.                 DOCUMENTATION ON IceOLR IN AMIGAGUIDE FORMAT.
  18.  
  19. 32   Fixed the file names this looks for on sysops systems, now
  20.      it looks for files starting with "IceBBS" rather than "VBBS"
  21.  
  22. 31   Added the keepfile requester (as in IceTERM), this will pop up
  23.      whenever you hit a keep button, it will by default be set to the
  24.      name of the last keepfile that was used, but if that is not suitable
  25.      you can select a new keepfile to use.
  26.  
  27.      Fixed the bug that was causing erratic crashes.  This was related
  28.      to moving between SIGS with the subject window open.
  29.  
  30.      When posting messages into the EMail sig, or replying to messages
  31.      in there, if you enter an address (not subject) that consists of
  32.      the single character '@', then the email system will ignore the
  33.      address and subject entered via the requester and it will assume
  34.      that the message body contains a valid internet message, which means
  35.      it must be something like:
  36.  
  37.         To: name@system.system.system
  38.         From: joe_bloe@amuc.mtroyal.ab.ca
  39.         Subject: ain't editing RFC-822 headers fun
  40.  
  41.         Hi name, this is
  42.         the whole message.
  43.  
  44.         Joe.
  45.  
  46.      Note that the blank line between the message header and the text MUST
  47.      be there, that's how USENET mail code figures out when to stop
  48.      processing the header.
  49.  
  50.  
  51. 30   Added some enhancements to the reply to message function, now you
  52.      can edit the existing subject line (instead of retyping it in)
  53.      and you can edit the reply to address.  The latter may be useful
  54.      for those who subscribe to mailing lists.
  55.  
  56. 29   Added support for the VERSION command, so typing:
  57.  
  58.        version iceolr full
  59.  
  60.      in a shell will do something useful.  Added support for the new
  61.      email SIG.
  62.  
  63. 28   Converted from Manx 5.2 to SAS 6.5.  Added protection against the
  64.      trim function creating huge files that fill the disk (in the case
  65.      of certain types of message base corruption).  If you get a requester
  66.      telling you that a SIG has bad offsets then you can either delete
  67.      that sig's .lnk and .dat file or you can add the INPLACE tooltype
  68.      and try trimming again as that might fix it.  If you find a way of
  69.      making new corrupt sigs please let me know so that I can fix it.
  70.  
  71.      Added more smarts to the autoquoting (highlighting of quoted text)
  72.      mechanism.
  73.  
  74.      The highlighted current subject in the subject window now moves
  75.      with you, no matter how you move from message to message.
  76.  
  77. 27b  The shell window that OLR opens to run PGP in will now appear on
  78.      the OLR custom screen (if one is being used).  Under AmigaDOS 1.3
  79.      it will appear on the workbench.
  80.  
  81. 27a  Minor change to how OLR summons the shell the PGP is run in,
  82.      also added the STACK= tool type, this can be used to specify
  83.      the stack that is to be set in the shell that PGP is running in.
  84.      Defaults to STACK=20000.
  85.  
  86. 27   Added some support for PGP.  Three things, a way to add keys to
  87.      your keyring, a way to test clear signed messages to see if they
  88.      come from the owner of the key and to see if they have been
  89.      tampered with, and a way to clear sign the messages and replies
  90.      that you post.
  91.  
  92.      To use these features you will need PGP 2.2 or higher installed
  93.      on your system and add a PGP= tool type to your OLR icon.  The
  94.      tool type is required for OLR to be able to fund and run PGP.
  95.      You should include the full directory path as well as the name of
  96.      the PGP program, for example:
  97.  
  98.        PGP=dh0:bin/pgp
  99.  
  100.      There are two new buttons: Test and +Key.  The Test button is used
  101.      to test the current message (if it is a clear signed PGP message)
  102.      to see if it comes from the author and is not a fake.  Note that
  103.      you need to have the author's key on your keyring for the test
  104.      to take place, PGP will tell you if it could not find the key.
  105.      The +Key button is used to tell PGP to search the current message
  106.      for public keys and if it finds any to add them to your keyring.
  107.  
  108.      IMPORTANT: do not go Testing or +Keying on non-pgp messages because
  109.      sometimes PGP will crash on messages it does not understand...
  110.  
  111.      The post and reply functions have a third button added to the
  112.      "Do you want to Post this message?" requesters.  This is the
  113.      "PGP sign it" button, if you hit this then PGP will be used to sign
  114.      the message (it does a "pgp -sta +clearsig=on" command) so that
  115.      other readers of the message can test it to ensure that it really
  116.      does come from you and that it has not been tampered with.
  117.  
  118.      Fixed the infamous -- extra character at end of message bug!
  119.  
  120.      Added the auto-highlighting of quoted text.  To enable this
  121.      feature you need to include a tooltype like:
  122.  
  123.         AUTOQ=2
  124.  
  125.      the number tells the system how many characters must match to
  126.      detect a quote, 2, 3 or 4 are good numbers.
  127.  
  128. 26   For sysops only, this updates the way the MSGID is built.
  129.  
  130. 25   Fixed the bug that was causing extra garbage at the end of some
  131.      messages.  Added the BBS list patch for EVP, if you specify a default
  132.      BBS with the BBS= tool type, then OLR will alway place that BBS at
  133.      the top of the list, that way when you finish reading that BBS
  134.      you will automatically get to see all the rest.
  135.  
  136. 24   Added support for 64 bit time stamps for generation of fully
  137.      unique message IDs for use in USENET postings.  Squeezed the
  138.      buttons in the horizontal mode control windows a bit tighter
  139.      together.  Fixed a couple of odd enforcer hits (one was causing
  140.      the infamous "I gotta hit the key a few times to get to the
  141.      next SIG" bug).  The "subject" display list window has been
  142.      enhanced a bit, now when you click in it to start reading messages
  143.      in the order they appear in the list the current message line
  144.      will highlight and when you hit the >> and << buttons (or keys)
  145.      the highlight will move.  The list will also scroll to keep the
  146.      highlight in view.  OLR no longer crashes when you wail on the
  147.      close window button.  Released the first version of the amigaguide
  148.      document for OLR.
  149.  
  150. 23   More cleanup relating to the strncpy() problem.  Added an alpha sort
  151.      mode to the "subject" display window (its a button labeled ABC).
  152.      Implemented tooltype replacement when snapshotting, this way the
  153.      tooltypes list in the icon does not keep growing.  Added support
  154.      for vertical mode in the brief configuration of the control pannel.
  155.      Packed the buttons in tighter in the both vertical control pannel
  156.      modes to give a bit more horizontal space on the display.
  157.      Added an auto start mode to the subject window, there is an additional
  158.      state to the gadget that brings this window up, this is: "None".
  159.      If you snapshot when none is selected then the subject window will
  160.      not appear whenever you start OLR.  If you snapshot when one of
  161.      the other states is selected it will cause the subject window to
  162.      appear in the desired mode when you restart OLR.
  163.  
  164. 22a  (13-Jul-93) Maintainance release: a line containing an end of comment
  165.      marker got deleted causing about 50 lines of gadget initialization
  166.      to disappear in a puff of smoke, could cause all sorts of wierd
  167.      behaviour!
  168.  
  169. 22   (12-Jul-93) Fix the bug where a horizontally scrolled message window
  170.      would not get reset properly when the next message was displayed.
  171.      Posting should now work with editors like Annotate which do not
  172.      let you edit a non-existant file.  Greatly enhanced the message
  173.      selection by subject window. To do this 5 additional buttons were
  174.      added (I can hear the groans already).  The only two you will need
  175.      most of the time are at the bottom of the first column, these are
  176.      the "Subj" and "Date" buttons.  The Subj button opens the subject
  177.      selection list and then allows you to select WHAT the list displays
  178.      (either subjects, authors or who the messages are addressed to).
  179.      The Date button selects how the list is SORTED.  You can sort by
  180.      posting date (the BBS date), by thread (all the messages regarding
  181.      one subject are kept togeather and sorted by date within that subject,
  182.      by author (all the messages by one author are togeather), or by
  183.      the name of the person the message is addressed TO.  So now you can
  184.      quickly see how many things Paul McLeod has put up for sale, or
  185.      look for the Danish whit of Erik, or...  The message dates can be
  186.      toggled on and off by clicking on the "Date/-no-" button that is
  187.      located in the new 5th row and the "Both/New" button is used to
  188.      select between the display of both read and unread or just unread
  189.      (new to you) messages.  The "Mark all" button is used to mark all
  190.      the messages in the current sig as read.  When you have selected
  191.      a message from the "subject" list the "<<" and ">>" keys will take
  192.      you up and down the messages IN THE ORDER THEY APPEAR IN THE
  193.      SUBJECT LIST.  Thus, if you want to re-read all the messages by
  194.      Jeff Rose (looking for spelink mistokes perhaps :-) you can do this
  195.      just by selecting a display of authors and then sorting it by author
  196.      (ie. both buttons set to Auth) and then click on the first one with
  197.      the mouse and then use the ">>" button to see all the rest.  The
  198.      "<<" and ">>" buttons will revert to their normal functions when
  199.      you either close the subject window or switch to another SIG.
  200.      You will notice that replies are indented by 2 spaces.  There are
  201.      also 4 indicator characters to the left, these are *DPL, for read,
  202.      deleted, permanent, and local.  Also, the subj/auth/to,
  203.      date/thrd/auth/to, date/-no-, and both/new buttons snapshot so
  204.      you can select the most useful settings and forget...
  205.  
  206.      There is one other little goodie, which people who run a 700+ by 400+
  207.      screen will enjoy.  To get it include the "VERT" tooltype and see...
  208.  
  209. 21   (9-Jul-93) Fixed the bug which prevented the Keepfile from being
  210.      written to if the BBS= tooltype was present (it was a wierdity
  211.      to do with strncpy()).  Added scrolling in all list displays
  212.      via the arrow keys, for true "hand's on the keyboard" reading.
  213.      The quotation header's date now reflects the true creation
  214.      date of the message that is being replied to.  Added support for
  215.      public screens (just like in TERM 99).  OLR's public screen is
  216.      called: VBBS-OLR.  If you are running under 1.3 OLR will work
  217.      as before.  If you are running under 2.0 OLR will use the public
  218.      screen method of opening your editor.  If your editor does not
  219.      support public screens then add the tooltype: WBHACK to your
  220.      OLR icon, and things will behave as before.  When OLR is used
  221.      under 2.0 it will now use the System() call instead of Execute()
  222.      this may result in some editors working which did not before.
  223.      Added an About menu item so that you can easily see the version
  224.      number.  And added a read by subject mode.  You will notice that
  225.      the subscribe button has been replaced by "Subjects", the subscribe
  226.      button is still there it's just on the far right now.  When you
  227.      hit Subjects OLR will scan the current sig and display a list
  228.      of the subjects of all the messages in that sig.  Any that you
  229.      have already read will have an asterisk beside them.  You can
  230.      read any message by just clicking on its name.  If you leave the
  231.      subject window open it will be updated as you move from SIG to SIG.
  232.  
  233.      The "Ed" editor (that lurks in your C: directory) is one of the
  234.      few editors I have found that supports public screens.  To get
  235.      it to work you need the following monster tooltype:
  236.  
  237.       EDITOR=ed window "RAW:0/0/640/200/Edit/SCREENVBBS-TERM"
  238.  
  239.      XDME (from Fish disk 776) can also be used, use a tool type of:
  240.  
  241.       EDITOR=xdme -ps VBBS-TERM
  242.  
  243.      for it.
  244.  
  245. 20   (20-Feb-93) Patch for sysop mode: the extra checks to see if a
  246.      BBS and SIG had been selected before posting or replying were
  247.      preventing a Sysop from posting or replying when in sysop mode.
  248.  
  249. 1.9  (20-Feb-93) Change for sysop mode: now it sets the LI_LOCAL flag
  250.      on postings and replies.  Added the QUIT "key" for KEY tooltype
  251.      definitions, this allows you to hit the close button and exit the
  252.      OLR just by hitting a key on the keyboard.  Added the FLASH
  253.      tooltype, include this one if you want to be "beeped" at the end
  254.      of a sig or BBS. When you have one of the small list type windows
  255.      open by not visable (ie. burried under something) you can now
  256.      bring it to the front by clicking on its button in the control
  257.      pannel again.  Removed the "do you want to quit" confirmation
  258.      requester, since it is safe to quit at any time without having to
  259.      re-read more than one message per sig.  Added saftey interlock
  260.      on the TRIM button.  When reading backwards (<<) and you hit the
  261.      begining of the sig it will take you to the end of the previous sig
  262.      (and act similarly between bbses).  If you hit post or reply when
  263.      not in a BBS or SIG it will now tell you to select something.
  264.      Added support for the LI_READ flag, this is set on a message by
  265.      message basis as you read each message.  There is now a trim
  266.      tooltype: TRIMREAD, when this is present in the icon then the
  267.      trim function will delete all the messages marked as read (regardless
  268.      of trim's date settings).
  269.  
  270. 1.8  (14-Feb-93) A "brief" control pannel has been added, which contains
  271.      fewer buttons, yet retains a significant portion of the functionality
  272.      of the main pannel.  The Full and Brief buttons are used to flip
  273.      between the two modes.  As well I have joined the header and text
  274.      windows into one (by popular request), of course now you might have
  275.      to edit out the header portion when you compose a reply...  And
  276.      keyboard equivalents have been added.  The exact key assignments
  277.      are up to you, a few defaults are set in the icon as an example.
  278.      There is one KEY= tool type per key you want to map to a gadget
  279.      (you can map several keys to one gadget if you wish):
  280.  
  281.         KEY=K|GADID|qual|qual|...
  282.  
  283.         where K is the key letter, GADID is the name of the gadget
  284.         that is to be mapped to the key and there are a variable
  285.         number of qualifiers which include:
  286.  
  287.           SHIFT   -- either of the shift keys
  288.           ALT     -- either of the ALT keys
  289.           AMIGA   -- either of the Amiga keys (the fancy A's)
  290.           CTRL    -- the control key
  291.           NUM     -- this is a key on the NUMeric key pad area
  292.  
  293.         qualifier keys MUST be held down at the same time as the key
  294.         they are attached to.
  295.  
  296.      The available GADIDs are:  (these are mostly the same as the
  297.      name of the gadget they represent)
  298.  
  299.        <<
  300.        >>
  301.        GOTOMSG
  302.        GOTOSIG
  303.        SUBSCRIBE
  304.        PREV
  305.        NEXT
  306.        PARENT
  307.        CHILD
  308.        PREVSIG
  309.        NEXTSIG
  310.        THREAD    - this is the "new/manual" button
  311.        ALLSUB    - this is the "all/sub" button
  312.        POST
  313.        KEEP
  314.        KILLAUTH
  315.        KILLSUBJ
  316.        EDITAUTH
  317.        EDITSUBJ
  318.        AUTHON
  319.        SUBJON
  320.        REPLY
  321.        PRIVATE
  322.        MOVE
  323.        DELETE
  324.        QUOTE     - the quotation mode selector
  325.        QINSEDIT  - the " >" key
  326.        QHEADEDIT - the "--" key
  327.        BBS
  328.        PERMANENT
  329.        TRIM
  330.        NET
  331.        BRIEF     - changes the large pannel into the small pannel
  332.                    or the small into the large.
  333.  
  334.      and since no one is going to read this anyway I won't bother
  335.      giving an example.
  336.  
  337. 1.7  (07-Feb-93) Minor change for sysops only, improves the speed of
  338.      reading in the s:vbbs.newsigs file.
  339.  
  340. 1.6  (06-Feb-93) Added the BBS= tooltype, this allows one to specify
  341.      the default BBS for OLR to start with (so you don't have to hit
  342.      the BBS button if you only usually read one bbs).  Fixed the enforcer
  343.      hits encountered when changing BBSes.  Added display of current
  344.      BBS name in the control window.  Now handles project icons for those
  345.      who need to use two different configurations for the same program
  346.      (note that OLR reads the tool icon first and then superimposes
  347.      any tooltypes found in the project icon, this allows one to put common
  348.      settings in the tool icon and specific settings in the project
  349.      icon, the file the project icon is attached to can be anything).
  350.      Fixed the bug in TRIM which was causing the message base files to
  351.      be completely emptied (instead of just leaving the last message
  352.      in them), this was causing people to re-download everything if
  353.      they used TRIM with a low time value (ie. less than a day).
  354.  
  355. 1.5  (01-Feb-93) Fixed a bug in the TRIM function that was causing
  356.      trimming to take an excessive amount of time, the bug was not
  357.      dangerous, just boring to watch...
  358.  
  359. 1.4  (31-Jan-93) First public release
  360.